---
title: Tingkatkan ke v5
description: Cara memperbarui proyek Anda dari Ultracite v4 ke v5.
---

Ultracite v5 adalah rilis besar dengan peningkatan signifikan dan perubahan yang memecah kompatibilitas. Panduan ini akan membantu Anda meningkatkan pengaturan v4 yang ada ke v5.

## Apa yang Baru di v5

- **Biome yang Diperbarui**: Ditingkatkan dari v1.x ke v2.x
- **Format Konfigurasi Baru**: Beralih dari `biome.json` ke `biome.jsonc`
- **CLI yang Ditingkatkan**: Ditulis ulang dalam TypeScript dengan penanganan kesalahan yang lebih baik
- **Integrasi Editor**: Dukungan bawaan untuk Cursor, Windsurf, Zed, dan GitHub Copilot
- **Git Hooks**: Integrasi opsional termasuk Husky, lint-staged dan lefthook
- **Skema yang Ditingkatkan**: URL skema baru dengan validasi yang lebih baik
- **Pengaturan VS Code yang Disederhanakan**: Penggabungan override tipe file ke dalam satu baris

## Langkah Migrasi

### Migrasi Otomatis (Disarankan)

Cara termudah untuk bermigrasi adalah menjalankan perintah inisialisasi baru:

```package-install
npx ultracite@latest init
```

Perintah ini akan:
- Memperbarui dependensi Anda ke versi terbaru
- Memperbarui `biome.json` atau `biome.jsonc` Anda  
- Memperbarui pengaturan VS Code Anda
- Menawarkan pengaturan aturan editor AI (Cursor, Windsurf, Zed, dll.)
- Menawarkan pengaturan integrasi baru (Git hooks, lint-staged, dll.)

Setelah peningkatan, Anda mungkin ingin meninjau file `biome.json` / `biome.jsonc` Anda untuk menghapus override apa pun. Selain itu, mulai ulang editor Anda untuk memastikan konfigurasi baru diterapkan.

Selain itu, harap juga tinjau Biome [panduan peningkatan v2](https://biomejs.dev/guides/upgrade-to-biome-v2/) untuk informasi lebih lanjut tentang perubahan skema / aturan.

### Migrasi Manual

Jika Anda lebih memilih kontrol lebih atas prosesnya, ikuti langkah [Migrasi Manual](/setup#manual-installation) dengan:

- Menginstal versi terbaru Ultracite dan Biome secara manual
- Memperbarui file `biome.json` Anda ke versi skema baru
- Memperbarui file `.vscode/settings.json` (opsional)
- Menambahkan file aturan editor AI (opsional)
- Menambahkan integrasi baru (opsional)

Setelah migrasi, mulai ulang editor Anda untuk memastikan konfigurasi baru diterapkan.